home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-21 / xcursr10.zip / XCURSOR.DOC < prev    next >
Text File  |  1992-09-24  |  6KB  |  112 lines
  1. XCURSOR 1.00
  2. Copyright (C) 1992, Quarterdeck Office Systems.
  3. All Rights Reserved.
  4.  
  5.     XCURSOR is a "quickie" program I tossed together in answer to a couple
  6.     of requests from customers.  This program allows you to select your 
  7.     mouse/pointer cursor in a number of ways.  If you don't want a mouse
  8.     cursor, you can enter "XCURSOR NONE".  You can get a default cursor by 
  9.     using "XCURSOR RESTORE".  You can use a standard X Cursor name or number
  10.     (use the "-list" command-line switch to see what's available), or you
  11.     can build bitmaps with the DESQview/X Icon Editor and use those to 
  12.     create a cursor.  You can specify foreground and background colors.  You 
  13.     can select from a "menu" of cursor choices.  It doesn't slice, dice, or 
  14.     make fries, but it does a pretty good job of letting you customize your 
  15.     mouse cursor.
  16.  
  17.  
  18. Syntax:
  19.     XCURSOR NONE
  20.   or
  21.     XCURSOR RESTORE
  22.   or
  23.     XCURSOR <X Cursor Name>
  24.   or 
  25.     XCURSOR <foremask> [<backmask> [<forecolor> [<backcolor> [<xhot> 
  26.     [<yhot>]]]]]
  27.   or
  28.     XCURSOR [-help | -?] [-pause] [-nopause] [-foremask x] [-backmask x] 
  29.     [-forecolor x] [-backcolor x] [-list] [-menu] [-xhotspot x] [-yhotspot x]
  30.     [-display x]
  31.  
  32. Where:
  33.     NONE will cause the X Cursor to disappear.
  34.     RESTORE will provide a default X Cursor.
  35.     <X Cursor Name> can be replaced with any string or numeric value as 
  36.         output by "XCURSOR -list".
  37.     <foremask> is the name of a bitmap file to use as a mouse cursor.  This
  38.         is not a pixmap, this is a single-plane bitmap.  These may be created
  39.         with the Icon Editor (save with File/Save As Bitmap...).  You may
  40.         also use an <X Cursor Name> here.
  41.     <backmask> is the name of a bitmap file to use as a background mask for 
  42.         the mouse cursor.  This is not a pixmap, this is is a single-plane
  43.         bitmap.  These may be created with the Icon Editor (save with File/
  44.         Save As Bitmap...).  You may also use an <X Cursor Name> here.  You
  45.         must specify <foremask> before you specify <backmask> if you are 
  46.         using the "short" syntax in the fourth example above.
  47.     <forecolor> is any valid X Color, such as Blue or #FCFCFC.  You must 
  48.         specify <backmask> before you specify <forecolor> if you are using 
  49.         the "short" syntax in the fourth example above.
  50.     <backcolor> is any valid X Color, such as Yellow or #3000C000FF00.  You 
  51.         must specify <forecolor> before you specify <backcolor> if you are 
  52.         using the "short" syntax in the fourth example above.
  53.     <xhot> is only used when a bitmap file has been specified as the mouse
  54.         cursor.  This is the X coordinate within the bitmap of the cursor's
  55.         "hot-spot".  You must specify <backcolor> before you specify <xhot> 
  56.         if you are using the "short" syntax in the fourth example above.
  57.     <yhot> is only used when a bitmap file has been specified as the mouse
  58.         cursor.  This is the Y coordinate within the bitmap of the cursor's
  59.         "hot-spot".  You must specify <backcolor> before you specify <yhot> 
  60.         if you are using the "short" syntax in the fourth example above.
  61.  
  62. Explanation of command-line switches:
  63.     -help             Displays a help text.
  64.     -?                Displays the long and short command-line switch forms.
  65.     -pause            Pauses the help display after each screenful.
  66.     -nopause          Disables pausing of help information.
  67.     -foremask <x>     Specifies <x> as the foreground bitmap or X Cursor Name.
  68.     -backmask <x>     Specifies <x> as the background bitmap or X Cursor Name.
  69.     -forecolor <x>    Specifies <x> as the foreground color.
  70.     -backcolor <x>    Specifies <x> as the background color.
  71.     -list             Lists the standard cursors.
  72.     -menu             Allows selection of a mouse from a menu.
  73.     -xhotspot <x>     Set the bitmap cursor's X HotSpot to <x>.
  74.     -yhotspot <x>     Set the bitmap cursor's Y HotSpot to <x>.
  75.     -display <x>      Specifies the display name (change the cursor on display
  76.                       <x>.
  77.  
  78. Bug reports/enhancements:
  79.     This program was written on my own time, and it is not an "official"
  80.     Quarterdeck product (so you can't hold my employer responsible for 
  81.     maintaining this program).  I will try to maintain it, but "maintaining
  82.     this program" falls below "family" and "Quarterdeck" on my priority 
  83.     list.  Even so, I'll do my best.
  84.  
  85.     If you have bug reports to make (or enhancements to suggest) please 
  86.     send them to:
  87.     
  88.     US Mail:
  89.         Steve Goodrich
  90.         Quarterdeck Office Systems
  91.         150 Pico Blvd
  92.         Santa Monica, CA  90405
  93.     Internet:
  94.         goodrich@qdeck.com
  95.  
  96.     Reports/requests phrased in a pleasant manner will have a much better 
  97.     chance of being done than those that are angry or abusive.    
  98.  
  99. And finally, the legal stuff:
  100.  
  101.     This software is provided "as-is" and without warranty of any kind, 
  102.     express, implied or otherwise, including without limitation, any 
  103.     warranty of merchantability or fitness for a particular purpose.
  104.  
  105.     In no event shall Steve Goodrich or Quarterdeck Office Systems be 
  106.     liable for any special, incidental, indirect or consequential damages 
  107.     of any kind, or any damages whatsoever resulting from loss of use, data 
  108.     or profits, whether or not advised of the possibility of damage, and on 
  109.     any theory of liability, arising out of or in connection with the use 
  110.     or performance of this software.
  111.  
  112.